home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / internet / nb32164.zip / NEWSBIN.TXT < prev   
Text File  |  1996-05-29  |  11KB  |  363 lines
  1.      NewsBin: Automated NNTP Downloader and Decoder for 95 and NT
  2.  
  3.     Ignore the register button, I haven't hooked it up yet sorry.
  4.  
  5.  
  6.     If you have any suggestions for improvements or bug reports - please
  7.     drop me a line at:
  8.  
  9.                     minor_c@mediasoft.net
  10.  
  11.  
  12.  
  13.  
  14. Introduction:
  15.  
  16.         Are you tired of having to manually download newsgroup binaries?
  17.     Well Newsbin is for you. Newsbin the unattended and automatic newsgroup
  18.     downloader and decoder short circuits the whole process by combining a
  19.     downloader, grouper and decoder into one package. Newsbin has many
  20.     features:
  21.  
  22.     - Shareware - test is as much as you want if you like it then
  23.         you pay the $10.00.
  24.  
  25.     - Tested on Win95 and Windows NT over SLIP and Ethernet
  26.  
  27.     - Unattended downloads - connect and let it download your groups
  28.     while you do something more interesting.
  29.  
  30.     - Isn't a resource hog. It is a good Windows multitasker meaning
  31.     that you can still use your machine for other things while the
  32.     downloads take place.
  33.  
  34.     - No temporary files are made on your machine. You just need enough
  35.     disk space for the binarys you download.
  36.  
  37.     - Groups news records together then automatically downloads and decodes
  38.  
  39.     - Keeps track of the last time it downloaded and won't download
  40.     records it has already seen.
  41.  
  42.     - Automatic and manual mode. Allows users on slow links to pick and
  43.     choose which files to download and allows user on high speed links
  44.     to download everything.
  45.  
  46.     - Allows you to download a complete list of newsgroups that your
  47.     server supplies.
  48.  
  49.     - Supports multiple servers - it will download from a list of
  50.     servers found in the INI file. When it finishes with one server, it
  51.     will go on to the next one in the list.
  52.  
  53.     - Supports up to 50 newsgroups (could easily be more if necessary)
  54.  
  55.     - Knows the SOCKS protocol, can get through firewalls even if your
  56.     protocol stack can't. Simply add the socks server to the INI file.
  57.     use the INI file that follows as a model.
  58.  
  59.     - You get all this in a program that is under 100K
  60.  
  61.  
  62. New for Rev 1.64 - Small enhancements and Bug Fixes.
  63.  
  64.     - Bar gauges that show current download status for every file.
  65.  
  66.     - Authenticated server support.
  67.  
  68.     - Better decoder.
  69.  
  70.     - Support for alternate ports.
  71.  
  72.     - Auto start and Auto stop now work right.
  73.  
  74.     - More robust menues.
  75.  
  76. New for Rev 1.63 - Small enhancements and Bug Fixes.
  77.  
  78.     - Save the current status of the download after every group - this
  79.       prevents crashes from screwing up all of the status saved up to the
  80.       point of the crash.
  81.  
  82.     - Support for Directory tree breakout, files can be downloaded to
  83.       directories that mirror the news group directories.
  84.  
  85.     - Modern UUEncoding replaces all spaces with ` symbols. I was
  86.       stripping spaces out, damaging files. No more.
  87.  
  88.     - still got the menu deletion bugs. Edit the INI file by hand for
  89.       best results at least until I get off my ass.
  90.  
  91. New for Rev 1.62
  92.  
  93.     - 1.62 is basically a bug fix. It fixes the more then 10 record
  94.       bug that was reported by several users.
  95.  
  96.     - It fixes the crash problem on Win95. Win95 has a serious bug in
  97.       the shutdown command. This command is used to perform a quick
  98.       shutdown of a socket. Under NT it works great, under 95 it often
  99.       blows up the kernel in the of the VXD's like VTDI or IFSMGR. I
  100.       blew it when I released 1.61 with this command enabled. I had been
  101.       experimenting with NT and forgot to remove it.
  102.  
  103.     - NewsBin still has those minor INI deletion bugs. Since I wanted
  104.       1.62 to be a fix for critical errors I chose to put off fixing
  105.       them until the next major release.
  106.  
  107.  
  108. New for Rev 1.61
  109.  
  110.     Rev 1.61 has been completely revamped. It now downloads on the fly
  111. using threads which are handed all the information they need to perform
  112. a download. While the download takes place, the header records are still
  113. downloaded. This mechanism was suggested by a user. It maximizes the use
  114. of modem bandwidth.
  115.  
  116.     - Files are downloaded as they are recognized instead of after all of the
  117.       headers are downloaded.
  118.  
  119.     - As many as 9 simultaneous files can be downloaded. Threads are selectable
  120.       from the front panel. I don't recommend using more then 4 or 5 threads
  121.       unless you have a special application.
  122.  
  123.     - Flushing of records is a thing of the past. When a thread
  124.       determines that a records isn't part of a file or that the file
  125.       already exists, it simply dumps the socket and the thread and
  126.       starts processing the next record. This greatly reduces the
  127.       bandwidth usage.
  128.  
  129.     - can be paused by setting the threads to zero. Once the current
  130.       downloads are complete the program will simply wait until you turn
  131.       the threads up again.
  132.  
  133.     - subject fields are cached in a file for a week. This reduces the
  134.       unwanted downloads that can occur if you delete a file in the
  135.       download directory but later re-download the header records for
  136.       it.
  137.  
  138.  
  139. Installation:
  140.  
  141.     Installation couldn't be simpler. Create a directory for Newsbin
  142.     then copy the ZIP file into the directory. pkunzip the file using
  143.     the command:
  144.  
  145.         pkunzip -d NB32163.ZIP
  146.  
  147.  
  148.     What this will do is place these three files into the subdirectory.
  149.  
  150.     1) newsbin.exe - the executable
  151.     2) newsbin.ini - the configurations file
  152.     3) newsbin.txt - this file
  153.  
  154.     It will create a subdirectory called "download" under the current
  155.     directory. The download directory is where the program places the
  156.     binaries that are downloaded from the Net.
  157.  
  158.     You now need to add Newsbin to one of your program groups.
  159.  
  160.     You need to edit the "newsbin.ini" file to customize it for your
  161.     installations. A sample INI file follows:
  162.  
  163.  
  164. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  165. ; Socks server - lets you get through a firewall of it is equiped with
  166. ; a socks daemon - socks requires a server to connect to and a
  167. ; userid may also be needed
  168. ; Uncomment by removing the semi-colons
  169. ;
  170. ; Uncomment to activate
  171. ;
  172. [SOCKSSERVER]
  173. ;SOCKS=SOCKS
  174. ; This is optional for most socks installations. but, don't leave it
  175. ; blank
  176. ;USERID=YOURUSERID
  177. ;PASSWD=YOURSOCKSPASSWD
  178.  
  179. ;
  180. ; List of servers to connect to - you must fill in your own server
  181. ;
  182. [SERVERS]
  183. server0=news
  184.  
  185. ;
  186. ; The news groups that you wish to check for binary files
  187. ; Notice the group and group numbers. The numbers must start
  188. ; at zero and be contiguous.
  189. ;
  190. ; The first number to the right is the last record that has been
  191. ; received from the news server. They are used to prevent the
  192. ; download of records that have already been received
  193. ; Zero it out if you wish to redownload the entire group
  194. ;
  195. ; The second number is either 1 or 0
  196. ;   1 means the group is active
  197. ;   0 means the gorup in inactive
  198. ;
  199. [GROUPS]
  200. group0=alt.binaries.sounds.mod 100 1
  201. group1=alt.binaries.warez.ibmpc 100 0
  202.  
  203. ;
  204. ; These are changed from the front panel of NEWSBIN. Either in the setup menu
  205. ; or from the front panel buttons
  206. ; it is unneccessary to change them here. Of course you can if you wish
  207. ; 1 means active
  208. ; 0 mean  inactive
  209. ;
  210. [MODE]
  211. ; Download automatically or not
  212. AUTO=1
  213.  
  214. ;Download List of all groups or not
  215. GROUP=0
  216.  
  217. ;Detail High Detail or not
  218. DETAIL=1
  219.  
  220. ; Autostart mode - start without requiring a click on the start menu
  221. AUTOSTART=0
  222.  
  223. ; Download Path
  224. DOWNLOADPATH=.\DOWNLOAD
  225.  
  226. ; UPLOAD Path
  227. UPLOADPATH=.\UPLOAD
  228.  
  229. ; Filename for the groups listing file
  230. GROUPFILENAME=groups.txt
  231.  
  232. ;
  233. ;
  234. ; Uploading will be activated later - depending upon demand of course
  235. ; and only for registered users.
  236. ;
  237. [UPLOAD]
  238. ; Who to post this stuff to
  239. POSTAGENT=news1
  240.  
  241. ; Maximum size in bytes  of records to post
  242. ; Some systems are limited to 64K
  243. FRAGSIZE=32000
  244.  
  245. ; Not Used yet but required duh!
  246. LINES=1100
  247.  
  248. ; Groups to Post to
  249. GROUPS=alt.binaries.pictures.erotica,alt.sex.pictures
  250.  
  251. ;
  252. ; These are changable on the non-shareware version
  253. ; of this software
  254. ;
  255. PATH=dufus@newsbin.com
  256. SUBJECT=NewsBin Auto Poster
  257. AGENT=NewsBin News Robot by CNM - minorc@mediasoft.net  Unregistered Shareware
  258. AUTHOR=RegisterNewsBin@10dollars.com
  259. ORGANIZATION=NewsBin
  260. NNTPPOSTINGHOST=dufus@newsbin.com
  261. NEWSREADER=NewsBin Robot Poster (CNM) Unregistered Shareware
  262. ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
  263.  
  264.     Once you do this you're pretty much done.
  265.  
  266. Use:
  267.  
  268.     To use Newsbin you simply double click the icon.
  269.  
  270. The Controls:
  271.  
  272.     1) The start button starts it
  273.  
  274.     2) The stop button terminates it.
  275.  
  276.     3) The Auto mode button toggles between automatic, unattended
  277.     download and manual download. Automatic is just what it sounds like.
  278.     In Manual mode Newsbin downloads all of the headers for a group and
  279.     asks you whether to download a file or not. This works best on slow
  280.     links.
  281.  
  282.     4) The threads knob allows you to crank up or turn down the maximum
  283.     number of threads that will simultaneously download files. Most of
  284.     the time I run 4 threads. This seems to work best for 28800
  285.     connections. Once over a satallite link I got maximum throughput
  286.     with 9 threads but, normally this only causes thrashing. Set it to
  287.     zero and when the current files are downloaded it will pause the
  288.     program. Simply turn them back up to continue.
  289.  
  290.     5) The setup menu hides a few more settings including
  291.  
  292.         A) The groups button toggles groups download. With it on, Newsbin
  293.         will download a complete list of newsgroups that the server
  294.         supports - keep it off if you're on a slow link. The listing is
  295.         huge.
  296.  
  297.         b) The detail button is for the geeks out there (and me). It
  298.         allows you to see the details of the NNTP transfers as they take
  299.         place. It doesn't effect the actual download.
  300.  
  301.         c) add and delete servers and groups.
  302.  
  303.         d) The autostart menu option - if set the program will start
  304.         downloading automatically when started.
  305.  
  306.         e) The manual/auto button simply mirrors the one on the front panel
  307.  
  308.         f) The group directories mode turns on downloading to specific
  309.             directories. For example if the download path is set to
  310.             C:\DOWNLOAD and the group is "alt.bunnies" then the actual
  311.             download directory will be C:\DOWNLOAD\ALT\BUNNIES. The
  312.             program will create the new directories for the newsgroups
  313.             but assumes that the download path already exists.
  314.  
  315. Begging:
  316.  
  317.     I've spent a lot of time writing and debugging this program. If you
  318.     like it please send me check or cash for $10.00 The address is:
  319.     
  320.     Checks to Conrad Minor
  321.  
  322.  
  323.     NewsBin
  324.     RT1. Box 73B
  325.     Paeonian Springs Va,
  326.     22129
  327.  
  328.     Make sure you include a mailing address and email address if
  329.     possible. That way I can notify you of upgrades and such.
  330.  
  331.  
  332.     What you get for paying me is:
  333.  
  334.     1) Peace of Mind
  335.  
  336.     2) A personalized copy of Newsbin that has you name in the about
  337.         screen.
  338.  
  339.     3) No begging window
  340.  
  341.     4) First notification when I release the next version of Newsbin
  342.  
  343.     5) Email tech support for Newsbin
  344.  
  345.  
  346.  
  347. Bugs:
  348.  
  349.  
  350. Improvements:
  351.  
  352. 1) Should be able to use the group list to update the list of groups
  353. in the INI file
  354.  
  355. 2) In manual mode, should be able to select from a list of suspected
  356. files instead of doing it one at a time.
  357.  
  358. 3) Add individual windows for each file that gets downloaded in order to
  359. watch the file status
  360.  
  361. 4) Display total bytes downloaded somewhere on the screen
  362.  
  363.